home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / jls.man < prev    next >
Text File  |  1992-10-06  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. jls                       User Commands                       jls
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      jls - list contents of a Jaquith archive directory.
  12.  
  13. SSYYNNOOPPSSIISS
  14.      jjllss   [--aarrcchh  _a_r_c_h_i_v_e]  [--sseerrvveerr  _h_o_s_t_n_a_m_e]   [--ppoorrtt   _p_o_r_t]
  15.      [--rraannggee  ((_d_a_t_e_1,_d_a_t_e_2)]  [--oowwnneerr  _n_a_m_e]  [--ggrroouupp _n_a_m_e] [--aabbss
  16.      _r_e_g_e_x_p] [--uu]] [[--aassooff _d_a_t_e] [--ssiinnccee _d_a_t_e] [--ffiirrsstt _n] [--llaasstt _n]
  17.      [--aallll]  [--mmooddddaattee]  [_f_i_l_e_l_i_s_t] [--ll] [--ii] [--uu] [--aa] [--ss] [--gg]
  18.      [--dd] [--RR] [--rraaww]
  19.  
  20. OOPPTTIIOONNSS
  21.      --aarrcchh _a_r_c_h_i_v_e Name of logical archive.  If  none  is  speci-
  22.                    fied,  the  environment  variable  JARCHIVE is
  23.                    used, if defined, else the default archive  is
  24.                    used.
  25.  
  26.      --sseerrvveerr _h_o_s_t_n_a_m_e
  27.                    Specifies host where Jaquith  server  is  run-
  28.                    ning.  Defaults  to  the  environment variable
  29.                    JSERVER.
  30.  
  31.      --ppoorrtt _p_o_r_t    Specifies port number where Jaquith server  is
  32.                    running.  Defaults to the environment variable
  33.                    JPORT.
  34.  
  35.      --rraannggee _d_a_t_e_1,_d_a_t_e_2
  36.                    List files with date in specified range.
  37.  
  38.      --oowwnneerr _n_a_m_e   List only files with specified owner name.
  39.  
  40.      --ggrroouupp _n_a_m_e   List only files with specified group name.
  41.  
  42.      --aabbss _r_e_g_e_x_p   List  files  which  match  _r_e_g_e_x_p   in   their
  43.                    abstract lines.
  44.  
  45.      --aassooff _d_a_t_e    List version which was current as of specified
  46.                    date. Equivalent to: -range(1-jan-1970,_d_a_t_e)
  47.  
  48.      --ssiinnccee _d_a_t_e   List versions between _d_a_t_e and  present  date.
  49.                    Equivalent to: -range(_d_a_t_e,_p_r_e_s_e_n_t-_d_a_t_e)
  50.  
  51.      --ffiirrsstt _n      List from the nth version in the date range.
  52.  
  53.      --llaasstt         List to the nth version in the date range.
  54.  
  55.      --aallll          List  all  the  versions   in   the   archive.
  56.                    Equivalent to: -first 1 -last -1
  57.  
  58.      --mmooddddaattee      Use the  file's  modification  date,  not  its
  59.                    archive date for all date comparisons.
  60.  
  61.  
  62.  
  63. Sprite v1.0                                                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. jls                       User Commands                       jls
  71.  
  72.  
  73.  
  74.      --ll            Display using long format (see below).
  75.  
  76.      --ii            Display buffer number where file lives, volume
  77.                    id  where buffer lives, and position on volume
  78.                    of buffer.
  79.  
  80.      --uu            Display  archive   date   instead   of   last-
  81.                    modification date (with -l option).
  82.  
  83.      --aa            Display abstract.
  84.  
  85.      --ss            Display file size in 1024 byte units.
  86.  
  87.      --gg            Display group name.
  88.  
  89.      --dd            Display directory name only.
  90.  
  91.      --RR            Display directory tree recursively.
  92.  
  93.      --rraaww          Display output in raw mode.  This  feature  is
  94.                    undocumented,  (you  are NOT presently reading
  95.                    this) and is subject to change/removal.
  96. _________________________________________________________________
  97.  
  98. DDEESSCCRRIIPPTTIIOONN
  99.      JJllss provides a simple directory  listing  mechanism  for  an
  100.      archive tape system controlled by the Jaquith program.
  101.  
  102.      The primary argument _f_i_l_e_l_i_s_t is a   file  expression  which
  103.      specifies  the  files  to be listed.  Shell-like globbing is
  104.      supported. '*' matches any number of characters. '?' matches
  105.      a  single  character. Additionally, curly braces can be used
  106.      to enclose alternatives.  For  example  foo.{bak,?}  matches
  107.      foo.bak, foo.c and foo.h.
  108.  
  109.      Note that any metacharacters which are not protected with  a
  110.      backslash  or  quotes  will be expanded by the shell, not by
  111.      the Jaquith system.
  112.  
  113.      The default action is to list the simple  filenames  of  the
  114.      most  recent  versions  of  matching  filenames.  The set of
  115.      files listed can be controlled by the use  of  one  or  more
  116.      options.  The options are all logically ANDed together; only
  117.      files matching all criteria are listed.
  118.  
  119.      The -range,  -first  and  -last  options  work  together  to
  120.      specify  a subset of the archived versions.  First, the date
  121.      range is applied, resulting in a list of candidates numbered
  122.      logically  from 1 to _n.  Then the first and last options are
  123.      applied to this list. First and last  can  be  positive  and
  124.      retrieve  the  specified  filenames from restricted list, or
  125.      they can be negative in which case they count from  the  end
  126.  
  127.  
  128.  
  129. Sprite v1.0                                                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. jls                       User Commands                       jls
  137.  
  138.  
  139.  
  140.      of  the list. Thus, the most recent version of a file can be
  141.      retrieved with 'first -1 last -1' without having to know how
  142.      many versions currently exist.
  143.  
  144.      _d_a_t_e is of the form _D_a_t_e_S_p_e_c[:_T_i_m_e_S_p_e_c]. _T_i_m_e_S_p_e_c is of  the
  145.      form   [hh[:mm[:ss]]],   and   _D_a_t_e_S_p_e_c   is   of  the  form
  146.      dd-month[-yyyy]. Month is the first 3 letters of the  month;
  147.      all  others  are  numbers. The '/' character is a substitute
  148.      for '-' and '.' may be used instead of ':'.
  149.  
  150.      By default jls simply lists the matching  filenames,  1  per
  151.      line.  In long form jls generates:
  152.  
  153.           _m_o_d_e _o_w_n_e_r_I_D _s_i_z_e _d_a_t_e _f_i_l_e_n_a_m_e
  154.  
  155.      With the --ii option the "inode" information is included:
  156.  
  157.           _t_B_u_f_I_d _v_o_l_I_d _f_i_l_e_m_a_r_k _m_o_d_e _o_w_n_e_r_I_D _s_i_z_e _d_a_t_e _f_i_l_e_n_a_m_e
  158.  
  159.      _d_a_t_e is the archive date if the -_u  option  is  given,  else
  160.      it's the file's last modification date.
  161.  
  162. BBUUGGSS
  163.      The option flags have little relation  to  the  standard  ls
  164.      options.
  165.  
  166.      No multicolumn formatting is provided.
  167.  
  168.      A file which matches more than one regular  expression  will
  169.      be listed multiple times.
  170.  
  171.      Only one archive can be specified at a time.
  172.  
  173.      Unlike the shell, the Jaquith globbing  characters  '*'  and
  174.      '?' match a '.' in the first position.
  175.  
  176.  
  177. SSEEEE AALLSSOO
  178.      jaquith jmgr jstat jput jget jctrl jcopy jclean jbuild
  179.  
  180.  
  181. KKEEYYWWOORRDDSS
  182.      jaquith archive
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sprite v1.0                                                     3
  196.  
  197.  
  198.  
  199.